home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat3 / Tk / option.z / option
Text File  |  1998-10-30  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4. ooooppppttttiiiioooonnnn((((3333TTTTkkkk))))                                                        ooooppppttttiiiioooonnnn((((3333TTTTkkkk))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      option - Add/retrieve window options to/from the option database
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ooooppppttttiiiioooonnnn aaaadddddddd _p_a_t_t_e_r_n _v_a_l_u_e ?_p_r_i_o_r_i_t_y?
  13.  
  14.      ooooppppttttiiiioooonnnn cccclllleeeeaaaarrrr
  15.  
  16.      ooooppppttttiiiioooonnnn ggggeeeetttt _w_i_n_d_o_w _n_a_m_e _c_l_a_s_s
  17.  
  18.      ooooppppttttiiiioooonnnn rrrreeeeaaaaddddffffiiiilllleeee _f_i_l_e_N_a_m_e ?_p_r_i_o_r_i_t_y?
  19.  
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      The ooooppppttttiiiioooonnnn command allows you to add entries to the Tk option database or
  23.      to retrieve options from the database.  The aaaadddddddd form of the command adds
  24.      a new option to the database.  _P_a_t_t_e_r_n contains the option being
  25.      specified, and consists of names and/or classes separated by asterisks or
  26.      dots, in the usual X format.  _V_a_l_u_e contains a text string to associate
  27.      with _p_a_t_t_e_r_n;  this is the value that will be returned in calls to
  28.      TTTTkkkk____GGGGeeeettttOOOOppppttttiiiioooonnnn or by invocations of the ooooppppttttiiiioooonnnn ggggeeeetttt command.  If _p_r_i_o_r_i_t_y is
  29.      specified, it indicates the priority level for this option (see below for
  30.      legal values);  it defaults to iiiinnnntttteeeerrrraaaaccccttttiiiivvvveeee.  This command always returns
  31.      an empty string.
  32.  
  33.      The ooooppppttttiiiioooonnnn cccclllleeeeaaaarrrr command clears the option database.  Default options
  34.      (from the RRRREEEESSSSOOOOUUUURRRRCCCCEEEE____MMMMAAAANNNNAAAAGGGGEEEERRRR property or the ....XXXXddddeeeeffffaaaauuuullllttttssss file) will be
  35.      reloaded automatically the next time an option is added to the database
  36.      or removed from it.  This command always returns an empty string.
  37.  
  38.      The ooooppppttttiiiioooonnnn ggggeeeetttt command returns the value of the option specified for
  39.      _w_i_n_d_o_w under _n_a_m_e and _c_l_a_s_s.  If several entries in the option database
  40.      match _w_i_n_d_o_w, _n_a_m_e, and _c_l_a_s_s, then the command returns whichever was
  41.      created with highest _p_r_i_o_r_i_t_y level.  If there are several matching
  42.      entries at the same priority level, then it returns whichever entry was
  43.      most recently entered into the option database.  If there are no matching
  44.      entries, then the empty string is returned.
  45.  
  46.      The rrrreeeeaaaaddddffffiiiilllleeee form of the command reads _f_i_l_e_N_a_m_e, which should have the
  47.      standard format for an X resource database such as ....XXXXddddeeeeffffaaaauuuullllttttssss, and adds
  48.      all the options specified in that file to the option database.  If
  49.      _p_r_i_o_r_i_t_y is specified, it indicates the priority level at which to enter
  50.      the options;  _p_r_i_o_r_i_t_y defaults to iiiinnnntttteeeerrrraaaaccccttttiiiivvvveeee.
  51.  
  52.      The _p_r_i_o_r_i_t_y arguments to the ooooppppttttiiiioooonnnn command are normally specified
  53.      symbolically using one of the following values:
  54.  
  55.      wwwwiiiiddddggggeeeettttDDDDeeeeffffaaaauuuulllltttt
  56.           Level 20.  Used for default values hard-coded into widgets.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ooooppppttttiiiioooonnnn((((3333TTTTkkkk))))                                                        ooooppppttttiiiioooonnnn((((3333TTTTkkkk))))
  71.  
  72.  
  73.  
  74.      ssssttttaaaarrrrttttuuuuppppFFFFiiiilllleeee
  75.           Level 40.  Used for options specified in application-specific
  76.           startup files.
  77.  
  78.      uuuusssseeeerrrrDDDDeeeeffffaaaauuuulllltttt
  79.           Level 60.  Used for options specified in user-specific defaults
  80.           files, such as ....XXXXddddeeeeffffaaaauuuullllttttssss, resource databases loaded into the X
  81.           server, or user-specific startup files.
  82.  
  83.      iiiinnnntttteeeerrrraaaaccccttttiiiivvvveeee
  84.           Level 80.  Used for options specified interactively after the
  85.           application starts running.  If _p_r_i_o_r_i_t_y isn't specified, it
  86.           defaults to this level.
  87.  
  88.      Any of the above keywords may be abbreviated.  In addition, priorities
  89.      may be specified numerically using integers between 0 and 100, inclusive.
  90.      The numeric form is probably a bad idea except for new priority levels
  91.      other than the ones given above.
  92.  
  93.  
  94. KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  95.      database, option, priority, retrieve
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.